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A Tool to Aid in Testing During the Development Cycle 


As desgns are devdoped with more and more aggresive schedules it becomes more important that each portion of the 
design works as expected. The most common way to ensure thisis through component testing prior to the final integration 
gage The SWAT” (SoftWareAnalyssTool) option for the M icrotek PowerPack® line of enulators provides the devdoper 
with a tool to perform rigorous testing right from the start of the project. By running thetests and saving the results during 
the devdopment, the designer is able to pass along not only hisdedgn, but a great deal of the testing required for final inte 
gration. The reult isa much snoother transtion from the ded gner’s workbench through syten integration and into the 
manufacturing environment. 
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A typical coding development begins with the engineer developing startup code for his project and then proceeding 
to the main portion of his program where functions are added to perform the application at hand. O nce code has 
been written, it needs to be tested to ensure it operates as expected and it has the performance necessary to 
meet the system's needs. To aid in this process the PowerPack emulator with SWAT allows the user to 
perform code coverage during the development of functions and performance analysis during the system | 
integration stage. T hese testing steps are easily integrated into the development cycle because the code 
requires no additional “instrumentation” to run the tests. T he user needs only activate the test feature = 
needed and the results are collected using the standard code with no additional compiling and linking required. 

Code coverage provides assurance the code “works as advertised” early in development. Performance analysis identifies 
bottlenecks early in development. 


After running the suite of tests, the developer can then check the code coverage results from the SWAT and decide if 
more tests are necessary to exercise the portions of code that were reported not covered by the SWAT. If the test cases 
are generated against a product require 
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continued from page 1 


Once the user has developed a test suite that gives the 
developed code complete coverage, he can store these 
tests and the results for use after the product has been 
integrated with renaining code and hardware. T hese 
are called regression tests. T he developer has checked 
each logical section of his code and has good confi- 
dence that the code “works as advertised”. A designer 
would repeat these steps with each module developed. 
T he resulting code has the benefit of having been com- 
pletely executed during testing. A further benefit is the 
creation of regression tests during development. 


T he benefits of this approach multiply as you approach 
system integration. T he resulting test suites are avail- 
able to be used as a basis for regression testing, easing 
the cost and time necessary to build complete integra- 
tion tests suites. T hese tests should then be augmented 
with more application specific tests to insure the func- 
tionality provided by the testing routines integrate and 
play correctly together. 
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At the system integration stage of deveopment two 
testing suites need to be used. One test suite is the 
regression tests. T he second is performance tests. T his 
Stage of testing covers any unexpected performance 
issues. Perhaps your application has a feature that uses 
functions that appeared quick enough stand alone, but 
are slow when used together. T hese issues are then 
addressed by performance testing. T his approach leads 
to a product that has reliability built in rather than 
hammered on in the last testing phase. Performance 
and quality have been addressed from the start of the 
project using a development tool that provides support 
for testing the overall design. Time spent preparing the 
code for incremental testing is minimal, since no code 
instrumentation is necessary. No additional compiling 
and linking are necessary. 
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System Features ata Glance: 


Coverage Analysis 


¢ 100% accurate instruction execution coverage even for cached and queued processors. 


* Can provide coverage analyas over two 1 M egabyte ranges with bytelevel resolution for 386 processors. The 486 class 
processors have two 512k ranges with byte leva resolution. Options exit to double the amount of code that can be covered. 


¢ Allowsthe user to view coverage to the object leva. 


* Mixed mode digplay automatically identifies unexecuted code 


Overview Performance Analysis 


¢ TheSWAT hardware accumulates time of execution at 
each program address and provides summations of time 
for symbolic ranges of modules and functions. 


¢ Thel megabyte hardware option can cover 256K bytes 
of address space, with two definable map ranges of 
128K each. Resolution of coverage can be changed to 
provide512K at 2 byte granularity, 1M at 4 bytes 
up to 64M at 256 byte resolution. 


* Can work in memory areas of 512k with resolution of 
2 bytes 


* Usesan independent clock source to provide 30nstime 
resolution, 


Employing the symbol table the SWAT provides accu- 
mulation results for modules, functions, and line 
numbers (386E X only). 


M easures time outside of defined ranges. 


Provides histogram views of absolute accumulated time 

per range or percentage of total time data as histograms 
by module or function; reports percentage of total timer, 

or absolute time spent in module or function. 


Results can be sorted by absolute or rdative time 
providing a quick view of program hot spots at the 
module or function levd. 
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SWAT Source Level Interface 


The SWAT performance tools are controlled by the PowerPack-SLD interface, which benefits from over 30 man- 
years of devdopment effort. T his full featured windows-based point and click interface provides complete C or 


ASM source level debugging. 


PowerPack-SWAT interface feature list: 


¢ Fully integrated into thePowerPack-SLD  /iezammzmm 
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¢ Histogram output showing absolute or rd 0 BoTHER 
ative time spent in modules or functions. 


* Can sect view of output to be sorted by 
results, by name or by address 


¢ Usescolor annotation of source code to 
show what lines are covered/not covered. 


¢ Allows the user to remove symbolic ranges 
from view and results calculation. 
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¢ Allows code coverage to be viewed at the 
assembly lev providing the detail necessary 
to uncover all unexecuted instructions. 
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void main Oo ¢ 
static unsigned long staticIterations = OL; 
/* initialize top pointer */ 

top = écell[0]: 


for ( 
f® 


tone cell at specified place */ 
cell[4] 3) 
PUSH 03 

0018:FF PUSH aoo00188 
0018:FFFFE3F8 CALL dn_func#83 (insert) 
0018:FFFFE3FD ADD SP, 08 

/* output all messages ( writing to ‘outbuf') */ 

11(): 

CALL dm_func#153 (printall) 


/* remove one cell from linked list */ 
renove(3): 

0018:FFFFE405 PUSH 03 

0018:FFFFE407 CALL dn_func#118 (remove) 

0018:FFFFE40C ADD ESP, 04 


/* output all messages ( writing to ‘outbuf') */ 


printall(); 
0018:FFFFE40F CALL dm_func#153 (printall) 


/* number of iterations */ 
staticlterations++; 
0018:FFFFE414 INC DWORD PTR [000001C4] 


* end of main */ 
0018:FFFFE41A JMP SHORT dm_main#67 (main) 
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TheM icrotek SWAT 
product assists the 
engineer in testing his 
new routines thereby 
speeding time to 
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market by reducing 
delays in system 
integration. 
386SWAT with PP-SWAT386-IMEG 386 Software PerformanceAnalyss Board with 1 M egabyte 
1MEG 
386SWAT with PP-SWAT 386-4MEG 386 Software PerformanceAnalyss Board with 4 M egabytes 
4MEG 
486SWAT with PP-SWAT486-IMEG 486 Software PerformanceAnalyss Board with 1 M egabyte 
1MEG Microtek makes it easy to keep your 
emulator up to date and in good 
: : : working condition, which is critical 
486SWAT with PP-SWAT 386-4MEG 486 Software PerformanceAnalyss Board with 4 M egabytes to our mutual success Join our 
4MEG Gold Support program and enjoy all 
the benefits of a complete warranty. 
For more information about Service 
Support O ptions to match your 
project requirenents, contact Lisa 
Rice at (800)886-7333x401 or 
(503)533-4463x4038. 
FAX E-MAIL WEB SITE 
LEZ (503) 533-0956 B info@microtekintl.com “> http://www.microtekintl.com 
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